home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / xfer42.arc / XFER42.DOC < prev   
Text File  |  1991-08-03  |  22KB  |  525 lines
  1.                            XFER 4.2
  2.  
  3.                    Superior DSZ/GSZ Control
  4.  
  5. Featuring:           Zmodem single file downloads.
  6.                      Zmodem BATCH downloads.
  7.                      Zmodem single file uploads.
  8.                      Zmodem BATCH uploads.
  9.                      Point and shoot file selection.
  10.                      Ymodem upload and download.
  11.                      #DSZ Ymodem-G upload and download.
  12.                      Xmodem upload and download.
  13.                      Easy to use pull down menus.
  14.                      Mouse support.
  15.                      Easy installation.
  16.  
  17. Everything you ever wanted in a Zmodem shell, and more.
  18.  
  19. ______________________________________________________
  20.  
  21. Copyright information:
  22.  
  23. XFER 4.2 and all other versions of XFER are copyright by the
  24. author, Russell B. Hildreth, and may not be sold, modified, or
  25. otherwise tampered with, without permission of the author. 
  26. The program is distributed as shareware; try it, and if you like
  27. it, register.  If you don't want to register, delete the program
  28. or give your copy to a friend.  Registering the program helps
  29. put the author through college.
  30.  
  31. There are no warranties associated with the program--use it
  32. at your own risk.  The author is not responsible for any
  33. damage that may result from the use of this software.
  34.  
  35. DSZ is a registered trademark of Omen Technology.  Use of
  36. that product obligates registration with Omen Tech.
  37.  
  38.  
  39. Document typeset 08/03/91 for 08/03/91 release of XFER
  40. Version 4.2.
  41.                        TABLE OF CONTENTS
  42.  
  43. ______________________________________________________
  44.  
  45.  
  46. Installation . . . . . . . . . . . . . . . . . . . . . . . 3
  47.  
  48. Upgrading. . . . . . . . . . . . . . . . . . . . . . . . . 4
  49.  
  50. Setting Up Your Comm Program . . . . . . . . . . . . . . . 5
  51.  
  52. What's New . . . . . . . . . . . . . . . . . . . . . . . . 8
  53.  
  54. Single File Downloading. . . . . . . . . . . . . . . . . .10
  55.  
  56. Batch File Downloading . . . . . . . . . . . . . . . . . .11
  57.  
  58. Single File Uploading. . . . . . . . . . . . . . . . . . .12
  59.  
  60. Batch File Uploading . . . . . . . . . . . . . . . . . . .13
  61.  
  62. Autodownload(tm) . . . . . . . . . . . . . . . . . . . . .14
  63.  
  64. Notes on DSZ . . . . . . . . . . . . . . . . . . . . . . .15
  65.  
  66. Notes on the Setup Menu. . . . . . . . . . . . . . . . . .16
  67.  
  68. The Mouse Interface. . . . . . . . . . . . . . . . . . . .18
  69.  
  70. Error handling . . . . . . . . . . . . . . . . . . . . . .19
  71.  
  72. Registering the Software . . . . . . . . . . . . . . . . .20
  73.  
  74. Contacting the Author. . . . . . . . . . . . . . . . . . .21
  75.  
  76. ______________________________________________________ INSTALLATION:
  77.  
  78. 1.     Quick and dirty:  Copy XFER.EXE and DSZ.COM into
  79.        the same directory as your communications program. 
  80.        
  81. 2.     The first time you run XFER (you can do this from the
  82.        command line if you desire) you should go to the
  83.        Setup menu and make any changes to the default
  84.        values that are necessary for your system.  Be sure to
  85.        set the proper COM port for your modem and the
  86.        upload and download directories you wish to use.  The
  87.        default COM port is COM1, and the default directory
  88.        for both uploads and downloads is C:\XFER.  Once
  89.        you have made all the changes you wish, select the
  90.        Save Setup option to make your settings permanent
  91.        (note, if you do not select the Save Setup option, your
  92.        changes will be lost the next time you run XFER).  See
  93.        the section on the Setup Menu for complete
  94.        information on that section.
  95.  
  96. 3.     Your permanent settings are stored in a file called
  97.        XFER.CFG, in the same directory as XFER and your
  98.        comm program.  Do not delete this file, or your
  99.        selected settings will be lost and the program will
  100.        return to the initial default values. UPGRADING FROM PRIOR VERSIONS:
  101.  
  102. 1.     Copy the new release of XFER.EXE into your
  103.        communications program directory, right over the old
  104.        version.
  105.  
  106. 2.     Erase any occurrences of old program versions--
  107.        XFER.COM and INSTALL.EXE.  INSTALL.EXE is no
  108.        longer necessary.
  109.  
  110. 3.     Edit your AUTOEXEC.BAT file to remove any
  111.        occurrences of the XFERDIR, XFERUP, or XFERDOWN
  112.        DOS environment variables.  These variables are no
  113.        longer necessary.  Also, you may remove any
  114.        occurrence of DSZPORT, if you will only be using
  115.        XFER to access DSZ.  You may wish to retain the
  116.        DSZPORT environment variable if you use other
  117.        programs to access DSZ, but XFER now ignores the
  118.        DSZPORT environment variable.
  119.  
  120. 4.     Copy DSZ.COM or GSZ.EXE into your
  121.        communications program directory if it is not there
  122.        already.  You should be using a version of DSZ dated
  123.        no earlier than 1990 (i.e., 01/19/90).
  124.  
  125. 5.     If you have an XFER.CFG file from a version of XFER
  126.        earlier than 4.2 (i.e., XFER 2.0), erase it.  Very old
  127.        XFER.CFG files will confuse XFER 4.1.  Upgrading
  128.        from XFER 4.0 also requires deleting the XFER.CFG
  129.        file, as the colorsetting feature adds new variables to
  130.        the file.
  131.  
  132. 6.     You may wish to reboot your computer if you have
  133.        made changes to your AUTOEXEC.BAT file.
  134.  
  135. SETTING UP YOUR COMM PROGRAM:
  136.  
  137. Find your comm program here (hopefully) and follow the
  138. directions.  If you've used similar programs before, this should
  139. be a snap.  If I have made any mistakes in this section,
  140. please let me know!
  141.  
  142. Procomm Plus 2.0:
  143. You can set XFER up to run under a Meta-Key in PCPLUS
  144. 2.0, by following these keystrokes from the terminal screen:
  145.        ALT-M
  146.        Highlight the desired key
  147.        R to revise
  148.        Set TYPE to PROGRAM
  149.        Set CONTENTS to XFER.EXE
  150.        Enter
  151.        S for Save
  152.        ESC
  153.  
  154. If you want to use XFER and DSZ for downloads, you should
  155. disable the automatic downloading in PCPLUS 2.0 with the
  156. following keystrokes:
  157.        ALT-S
  158.        P
  159.        Z
  160.        C
  161.        N
  162.        Enter
  163.        ESC
  164.        ESC
  165.        S
  166.        ESC
  167. Procomm 2.4.x (shareware version):
  168.        From the terminal screen, enter the following           
  169.        keystrokes:
  170.               ALT-S
  171.               4 <return>
  172.               1 <return>
  173.               XFER.EXE
  174.               <esc>
  175.               S <return>
  176.               <esc>
  177.               ALT-X
  178.         To execute XFER.EXE press ALT-A.
  179.  
  180. Procomm Plus (test drive or retail, versions PRIOR to 2.0):
  181.        From the terminal screen, enter the following
  182.        keystrokes:
  183.               ALT-S
  184.               F
  185.               F -or- G
  186.               XFER <return>
  187.               <esc>
  188.               S
  189.               <esc>
  190.               ALT-X
  191.               Y
  192.        To execute XFER.EXE, press ALT-J -or- ALT-U,
  193.        depending on which hotkey you choose in the 3rd
  194.        step above.
  195.  
  196. Qmodem SST:
  197.        From the terminal screen, enter the following
  198.        keystrokes:
  199.               ALT-J
  200.               1
  201.               @SHELL XFER
  202.               <return>
  203.               <esc>
  204.               <esc>
  205.               ALT-X
  206.               Y
  207.        To execute XFER.EXE, press F1.
  208. Telix 3.xx:
  209.        From the terminal screen, enter the following
  210.        keystrokes:
  211.               ALT-O
  212.               F
  213.               H {note, this should be Editor}
  214.               XFER.EXE <return>
  215.               <return>
  216.               W
  217.               ALT-X
  218.               Y
  219.        To execute XFER.EXE, press ALT-A.
  220.                   WHAT'S NEW IN VERSION 4.2?
  221.  
  222. Version 4.2 adds support for the new GSZ.EXE program
  223. recently released by Omen Technology.  Also, XFER now
  224. supports the OZBExt program for Compuserve Quick B
  225. protocol downloads.  You can find GSZ and OZBExt on
  226. Compuserve.
  227.  
  228.                   WHAT'S NEW IN VERSION 4.1?
  229.  
  230. Version 4.1 adds the color setting utility to the Setup menu.
  231.  
  232.                   WHAT'S NEW IN VERSION 4.0?
  233.  
  234. Version 4.0 marks a complete change in the user interface
  235. and a change in the direction of DSZ features supported. 
  236. First of all, the new version features a standard pull down
  237. menu system, making the program extremely intuitive and
  238. easy to use for anyone.  It's even easier to use with a mouse.
  239.  
  240. Second, the new version includes for the first time support for
  241. DSZ protocols other than Zmodem.  The idea behind this is
  242. that many people now own MNP error correcting modems
  243. and may wish to use the Ymodem-G protocol included in the
  244. registered copy of DSZ for maximum efficiency on MNP
  245. modems.  I decided that if I was going to add Ymodem-G
  246. support I would go all the way and add support for everything
  247. that I could find in the DSZ documentation.  This makes XFER
  248. the most complete DSZ shell in existence.
  249.  
  250. Some other little changes in 4.0 include a move away from
  251. the DOS environment variables used to store settings.  This
  252. method of setting defaults was becoming very complicated as
  253. I added features to XFER, and I decided that with the new pull
  254. down menus the easiest thing for the end user would be a
  255. setup menu with all options easily selectable.  Setup options
  256. are now stored (once again) in XFER.CFG (use the Save
  257. Setup option on the Setup menu to save your settings).
  258.  
  259. The fact that everything is now centered around the pull down
  260. menus means that it is *very* easy to add more features, so
  261. while I was at it I added some extra Zmodem support,
  262. including Crash Recovery support.  If there are any other DSZ
  263. features you would like to see supported (I'm sure there are
  264. plenty that I've missed), let me know and I'll get them into a
  265. future release of XFER.                    SINGLE FILE DOWNLOADING:
  266.  
  267. This is pretty straightforward:  You call up XFER.EXE from
  268. your comm program after telling whatever bulletin board you
  269. are logged onto that you are starting a download, select the
  270. protocol, X, Y, or Z, that you wish to use, and then choose
  271. Download.  For a single file download, you should select
  272. option [D] (download) from the XFER menu, or move the
  273. mouse cursor to the Download line and click any mouse
  274. button.  You can also hit the <ESC> key to exit.  You'll get
  275. the hang of it quickly, especially if you've used similar
  276. programs.
  277.  
  278. Depending on the protocol there might be more than one
  279. Download option.  If you are in doubt about what an option
  280. does, use the standard Download selection.
  281.  
  282. When the transfer is completed some Bach music will be
  283. played.  If you get sick of listening to old Johann, you can hit
  284. the spacebar or any other key and you will be dumped back
  285. into your comm program.  If you get REALLY sick of Johann,
  286. turn him off on the Setup menu (NoBach).
  287.  
  288.                     BATCH FILE DOWNLOADING:
  289.  
  290. This works just like single file downloading, but you can get
  291. several files at one time, with no further keyboard input.  Not
  292. all protocols and/or BBS systems support batch transfers, but
  293. for those that do this is a very handy option.
  294.  
  295. Start the batch transfer on the BBS end, using whatever
  296. method the BBS you are logged onto requires for a batch
  297. download--you will have to specify each file you wish to
  298. download.  
  299.  
  300. Once you have started the BBS downloading, call up XFER
  301. from your comm program as specified in the setup section. 
  302. Select batch download.  Each file will be downloaded and
  303. placed in your up/download directory.  That's all there is to it. 
  304.  
  305. Although DSZ is supposed to automatically detect a batch
  306. transfer in the standard receive mode, experience has shown
  307. that not all DSZ releases always work properly unless forced
  308. to receive a batch download.
  309.                     SINGLE FILE UPLOADING:
  310.  
  311. Inform the BBS system to which you are connected that you
  312. wish to upload a file.  Once the BBS is ready to receive, call
  313. up XFER from your comm program as specified in the setup
  314. section.  Select the Upload option under whichever protocol
  315. you have chosen.
  316.  
  317. You will be placed in a point and shoot file selection system
  318. which will show all of the files in your up/download directory. 
  319. Using the cursor keys, highlight the file you wish to upload,
  320. and press <ENTER>.  That file will be uploaded.
  321.  
  322. Currently there is no error checking, but DSZ will quickly
  323. inform you if it didn't find the file (impossible with the point
  324. and shoot mechanism).  In a future version I'll add some more
  325. user friendly error checking.
  326.  
  327. You can press <ESC> to abort and return to the main menu.
  328.                      BATCH FILE UPLOADING:
  329.  
  330. This works the same as single file uploads, but you get to
  331. specify as many filenames as you like.  Inform the BBS
  332. system you are connected with that you wish to initialize a
  333. batch upload.  When it is ready to receive files, call up XFER
  334. from your comm program as specified in the setup section. 
  335. Select Batch Upload under the Zmodem menu.
  336.  
  337. You will be placed in the point and shoot file selector system,
  338. which will show all of the files in your up/download directory. 
  339. Highlight each file you wish to upload and press <ENTER>. 
  340. Keep specifying files until you are done, then hit <ESC>. 
  341. The list of files is stored in Z.LST in your comm program
  342. directory, and DSZ checks that list and uploads them all.  As
  343. soon as you press <ESC> the transfer will begin.
  344.  
  345. Be generous and send your favorite local board about 30
  346. files, and go off to the market.
  347.  
  348. If you need to transfer the same set of files repeatedly, see
  349. the information on the NoRemove Setup menu option.
  350.                          AUTODOWNLOAD:
  351.  
  352. The AutoDownload(tm) mode of DSZ allows you to initialize a
  353. file transfer from a BBS system and receive the file(s)
  354. immediately without any further action on your part.  This is
  355. convenient, but limits the use of your communications
  356. programs features--the autodownload mode takes over,
  357. locking out your comm program, so using this mode is a
  358. tradeoff.  Try it out and see what you think.
  359.  
  360. After logging onto a BBS system, call up XFER from your
  361. comm program as specified in the setup section.  Select
  362. Autodownload on the Zmodem menu.  DSZ will take control. 
  363. You can go about your BBSing business, and as soon as you
  364. initiate a download it will begin.  See the DSZ documentation
  365. on using and terminating the Autodownload mode.
  366.                          NOTES ON DSZ:
  367.  
  368. WARNING:  You should try to use a current version of
  369. DSZ.COM at all times.  The XFER shell attempts to make use
  370. of all of DSZ's latest features, and if your version of DSZ is
  371. out of date, XFER may not function with it.  For example, the
  372. MobyTurbo(tm) feature of DSZ is supported by XFER, and if
  373. your version of DSZ is too old, the two programs will not work
  374. together.  New versions of DSZ are released regularly (about
  375. every other month, sometimes more often) and you should try
  376. to keep up with them.
  377.  
  378. Where to obtain a copy of DSZ if you don't already have one: 
  379. DSZ.ZIP is maintained on Compuserve in the IBMCOM
  380. Protocols library (go IBMCOM) and on many bulletin boards
  381. around the country.  Look for DSZ.ZIP or DSZ????.ZIP, where
  382. the question marks are day and month digits (i.e.,
  383. DSZ1119.ZIP, would be the November 19th release in the
  384. current year).  DSZ/GSZ is also available directly from Omen
  385. Technology by modem at 503-621-3746.
  386.  
  387. Certain DSZ features, such as Ymodem-G, require registration
  388. of DSZ.  These features are marked on XFER menus and in
  389. the DSZ documentation with a pound symbol (#).  If you wish
  390. to access these features, registration of DSZ is required.                    NOTES ON THE SETUP MENU:
  391.  
  392. All setup options are configurable under the Setup menu. 
  393. This setup method takes the place of the DOS environment
  394. variable method used by previous versions of XFER, making
  395. setup easier for the end user.
  396.  
  397. 1.     Directories:  This option allows you to configure which
  398.        directories will be used for uploads and downloads. 
  399.        Each directory can be configured separately, allowing
  400.        you to use a different directory for each type of
  401.        transfer.  If you wish to use the same directory for both
  402.        uploads and downloads, simply specify the same
  403.        directory name.  You may or may not include a drive
  404.        specification.  If you wish to specify directories on a
  405.        drive other than the one from which XFER is run, you
  406.        must specify a drive.
  407.  
  408. 2.     Comm Port:  This option allows you to tell XFER which
  409.        communications port your modem is attached to.  The
  410.        default value is COM1.  Note that this must be
  411.        correctly set for XFER to work, regardless of whether
  412.        you have set the DSZPORT environment variable. 
  413.        XFER ignores that variable and uses the port specified
  414.        on the Setup menu.
  415.  
  416. 3.     Sound:  This option allows you to select the level of
  417.        sound you desire, from the default Full Sound, which
  418.        plays Bach music at the end of a transfer, to No
  419.        Sound, which offers complete silence.
  420.  
  421. 4.     ProMice:  This option allows users of Neil
  422.        DeChambeau's ProMice mouse menus for Procomm
  423.        to properly enable the mouse after exiting XFER.  Only
  424.        turn this option on if you are using the ProMice
  425.        system.  Also, note that the MENU program and the
  426.        PROCOMM menu definition file must be either in the
  427.        same directory as XFER or in your DOS path.
  428.  
  429. 5.     Remove Z.LST:  This option allows you to tell XFER
  430.        whether to keep or delete the Z.LST batch file list at
  431.        exit.  If you select Remove On (the default), Z.LST will
  432.        always be deleted.  If you select Remove Off, Z.LST
  433.        will be retained and used the next time you choose a
  434.        Zmodem batch upload.  This setting is useful for
  435.        business types who need to transfer the same set of
  436.        files on a repeating basis, or people who want to
  437.        upload the same set of files to several different places.
  438.  
  439. 6.     Z Program:  Use this option to select either DSZ or
  440.        GSZ.
  441.  
  442. 7.     Color Setting options:  Use these to pick your favorite
  443.        colors if you don't like the defaults.  Experiment to find
  444.        out what works best for you.
  445.  
  446. 8.     Save Setup:  Always select or click on this after you
  447.        have made changes that you wish to make permanent,
  448.        or your changes will be lost.  This option simply writes
  449.        your changes to disk for future reference by XFER. 
  450.        Changes are not automatically written to disk, as you
  451.        may on occasion wish to make temporary changes
  452.        (i.e., change the download directory for a single
  453.        transfer).                      THE MOUSE INTERFACE:
  454.  
  455. If you have a mouse you will be able to use it to select menu
  456. items and pick files for uploading.  If you don't have a mouse
  457. you can skip this section.  A mouse is not required for the
  458. program to operate.
  459.  
  460. To select a menu option, place the mouse cursor on the
  461. menu item you want and click any button.
  462.  
  463. To ESCAPE from main menu you can press the right mouse
  464. button (works just like pressing the ESC key).
  465.  
  466. To select a file in the point and shoot file selection window,
  467. put the mouse cursor on the desired file and click any button.
  468.                         ERROR HANDLING:
  469.  
  470. Or rather lack thereof.  In order to keep the program size
  471. down I have left out most error handling.  Only the very
  472. minimum has been provided, which means it is up to you to
  473. be sure to set things up properly, and check the instructions
  474. if things don't go right the first time.
  475.  
  476. If you have set something wrong, you will probably get some
  477. sort of DOS error message or nothing will happen. 
  478. Possibilities include:
  479.  
  480. Bad command or file name:  This probably indicates that
  481. DSZ.COM is not in the same directory as XFER.EXE.  XFER
  482. is designed to be run from your communications program
  483. directory, and to find DSZ there.  Do not try to use any batch
  484. files that change directories or run XFER from another
  485. directory.
  486.  
  487. DSZ runs but doesn't download to the proper directory:  You
  488. probably specified an improper directory under the Setup
  489. menu.  Check there and try again.
  490.                    REGISTERING THE SOFTWARE:
  491.  
  492. Registering:  It costs $10 to register, half the price of DSZ.  I
  493. won't indulge myself further and go on a lengthy tirade about
  494. the ethics of registering.  You know what to do.  If you don't
  495. want to pay, don't use the software.  Delete it from your hard
  496. drive and give any floppy copies to friends.
  497.  
  498. What do you get for registering?  The latest version of the
  499. software if there is one, or the next release.  You'll also get a
  500. nice typeset copy of the documentation.  I also have an
  501. inclination for doing things that people ask--if you want some
  502. special custom modification I'll probably do it.  You also get
  503. to feel good.
  504.  
  505.                      CONTACTING THE AUTHOR
  506.  
  507. If you have a problem, I'm here.  Likewise for suggestions. 
  508. Oh, for registrations, too!  On Compuserve, send EasyPlex
  509. mail to 71041,2132, or write to:
  510.               
  511.                      Russell Hildreth
  512.                      P.O. Box 72431
  513.                      Davis, CA  95617-2431
  514.  
  515. I want to hear from you.  Tell me anything you think might
  516. apply.  Tell me how you set up the program with some off
  517. brand comm program.  Tell me what you'd like to see added
  518. in a future version.  Tell me to jump off a cliff.  Tell me
  519. anything.
  520.  
  521. The author is ALWAYS very open to your suggestions, and
  522. they are usually implemented into a future edition of the
  523. software.  
  524.  
  525.